home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / COM / World Wide Web Weaver.sit / World Wide Web Weaver / World Wide Web Weaver 1.1.1 д / Extras / MacWebLint 1.011 / README < prev   
Text File  |  1995-12-06  |  4KB  |  106 lines
  1.  
  2.               Weblint, Version 1.011
  3.  
  4.         Copyright (c) 1994, 1995 Neil Bowers.  All rights reserved.
  5.                            Khoral Research, Inc.
  6.  
  7.     This program is free software; you can redistribute it and/or modify
  8.     it under the terms of the "Artistic License".  You should have received
  9.     a copy of the Artistic License with this distribution, in the file named
  10.     "Artistic".  If not, I'll be glad to provide one.
  11.  
  12. --------------------------------------------------------------------------
  13.  
  14. Weblint is a syntax and minimal style checker for HTML: a perl script which
  15. picks fluff off html pages, much in the same way traditional lint picks fluff
  16. off C programs.  Files to be checked are passed on the command-line:
  17.  
  18.     % weblint *.html
  19.  
  20. Warnings are generated a la lint -- <filename>(line #): <warning>. E.g.:
  21.  
  22.     home.html(9): unmatched </H2> (seems to match <H1> on line 8)
  23.  
  24. The following checks are currently performed:
  25.  
  26.     *    basic structure
  27.     *    unknown elements and element attributes.
  28.     *    context checks (where a tag must appear within a certain element).
  29.     *    overlapped elements.
  30.     *    expects to see a TITLE in the HEAD element.
  31.     *    do IMG elements have ALT text?
  32.     *    illegally nested elements.
  33.     *    mis-matched tags (e.g., <H1> ... </H2>)
  34.     *    unclosed elements (e.g., <H1> ... )
  35.     *    catches elements which should only appear once
  36.     *    flags obsolete elements.
  37.     *    odd number of quotes in tag.
  38.     *    order of headings.
  39.     *    potentially unclosed tags.
  40.     *    flags markup embedded in comments --- this can confuse some browsers.
  41.     *    whines if you use `here' as anchor text :-)
  42.     *    tags where attributes are expected (e.g. anchors).
  43.     *    existence of local anchor targets.
  44.     *    flag case of tags (not enabled by default).
  45.     *    expect a <LINK REV=MADE HREF=mailto:...> in HEAD element
  46.     (not enabled by default).
  47.     *    supports HTML 3 elements, such as TABLE, MATH, FIG and the rest.
  48.  
  49. All warnings can be enabled or disabled, using a configuration file,
  50. $HOME/.weblintrc.  A sample configuration file, weblintrc, is included
  51. in the distribution.
  52.  
  53. --------------------------------------------------------------------------
  54.  
  55. Installation
  56.  
  57. A simple Makefile is provided, in which you may want to modify BINDIR
  58. and MANDIR, which specify where the weblint script and manpage should
  59. be installed.
  60.  
  61. Weblint uses the `newgetopt.pl' and `find.pl' libraries, which are part
  62. of the standard perl library, so this will hopefully not cause any problems.
  63. Please let me know if it does.
  64.  
  65. The manpage (weblint.1) should be installed in a directory where it
  66. will be picked up by man (e.g., /usr/local/man/man1 on our machines).
  67. A postscript version of the manpage (weblint.ps) is included in this
  68. distribution.
  69.  
  70. Weblint is available via anonymous ftp, either as a gzip'd tar file,
  71. or zip'd archive:
  72.     ftp://ftp.khoral.com/pub/perl/www/weblint-1.011.tar.gz
  73.     ftp://ftp.khoral.com/pub/perl/www/weblint.zip
  74. or you can get it from the weblint home page:
  75.     http://www.khoral.com/staff/neilb/weblint.html
  76.  
  77. The weblint distribution includes a simple regression testsuite.
  78. Run the testsuite with either of the following commands:
  79.  
  80.     % make test
  81.     % ./test.pl
  82.  
  83. If any of the tests fail, please mail the logfile (weblint-test.log) to me.
  84.  
  85. --------------------------------------------------------------------------
  86.  
  87. I hope you find this useful.  Comments, suggestions and bug reports are
  88. welcome, see my email address or home page, given below.  Sample html
  89. helps when tracking down problems.
  90.  
  91. I maintain two email lists:
  92.  
  93.     weblint-announce@khoral.com
  94.         Announcements for new versions of weblint.
  95.  
  96.     weblint-victims@khoral.com
  97.         Discussion related to weblint (such as what features
  98.         should be added), as well as announcements for new
  99.         versions of weblint, and pre-release testing.
  100.  
  101. Email me if you want to be added to either list.
  102.  
  103. Neil Bowers
  104. Khoral Research, Inc.
  105. <neilb@khoral.com>    http://www.khoral.com/staff/neilb/
  106.